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About the sample 

The Subform Set sample demonstrates the behavior of a dynamic PDF form. The sample consists 
of four sub-samples, which demonstrate the instantiation behavior of the Subform Set object 
according to the varying relationships of the subform type and occurrence values. The sample 
form contains numbered notes represented as black circles with white numbers—each is 
explained in more detail in the "About the output" section. For information about creating forms, 
see the LiveCycle Designer Help. 


Getting started 

To get started, you need the following files: 


Form: 

SubformSet1.xdp 

SubformSet2.xdp 

SubformSet3.xdp 

SubformSet4.xdp 

The LiveCycle Designer form file located in the Forms 
folder. 

Data: 

DataA.xml 

DataB.xml 

The XML data files located in the Data folder. 

Output: 

SubformSetl DataA.pdf 

The rendered forms with merged data located in the 


SubformSetl DataB.pdf 
SubformSet2 DataA.pdf 
SubformSet2 DataB.pdf 
SubformSet3 DataA.pdf 
SubformSet3 DataB.pdf 
SubformSet4 DataA.pdf 
SubformSet4 DataB.pdf 

Outputs folder. 


Running the sample 

You can run the sample by following these steps. 

1. Open one of the forms in LiveCycle Designer, for example SubformSetl.xdp. 

2. To specify the preview options, select File > Form Properties. Click the Defaults tab and do the 

following: 

• In Preview Type, select Print Form. 

• In Data File, browse to the Data folder and select one of the sample data files, for example 
DataA.xml. 

• Click OK. 

3. To preview the form, click the Preview PDF tab. 
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Results 

The output sample PDF files in the Outputs folder show the rendered forms merged with each 
of the two sets of data. Use these files to compare to the results of the previewed form. 


About the output 

Note: The following numbered comments correspond to the numbered black-circle icons on 
the Subform Set sample form. 

O Data 

Two sample data files are available for this sample. This section provides the name of the 
data file merged with the form along with the content of the data file. This information is 
useful for comparing the data displayed in section 3, "Subform Relationship". 

© Subform Occurrence 

Each form contains three subforms. This section provides the occurrence value, Min Count 
and Max, of the subforms. The occurrence values are specified in the Binding tab of the 
Object palette. 


Subforms specifications per form 



subformA 

subformB 

subformC 

SubformSetl.xdp 

Min Count = 0 Max =-1* 

Min Count = 0 Max = -1* 

Min Count = 0 Max = -1* 

SubformSet2.xdp 

Min Count = 0 Max = 1 

Min Count = 0 Max = 1 

Min Count = 0 Max = 1 

SubformSet3.xdp 

Min Count = 1 Max = 1 

Min Count = 1 Max = 1 

Min Count = 1 Max = 1 

SubformSet4.xdp 

Min Count = 2 Max = 2 

Min Count = 1 Max = 1 

Min Count = 3 Max = 3 


*The Max value is unlimited when the Repeat Subform for Each Data Item option, located in the Binding tab of the Object 
palette, is enabled and the Max option is left unchecked. 


© Subform Relationship 

The third section contains three columns used to compare the layout of the subforms inside 
different relationship types: 


Column 

Type 

Comments 

1 

Use All Subforms in Order 

The subforms are instantiated in the order in which 
they are declared in the form. This has the effect of 
potentially reordering the content to satisfy the form 
order. 

2 

Select One Subform from 
Alternatives 

The subforms are exclusive of each other, and only 
one subform may be instantiated. The determination 
of which subform to instantiate is based upon the 
data. 


Licenses and Copyrights 

For a complete list of the copyright notices for this product, see the copyright and 
trademarks page in the documentation. 
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